pp108 : createservicecontainer - Ant Task

createservicecontainer - Ant Task

Description

createservicecontainer Ant task creates a Service Container in an organization of Process Platform instance.

Sample Usage

The following example describes a procedure to create a Service Container WS-AppServer container in Service Group WS-AppServer Test group which is available in myorganization.

<createservicecontainer abortTime="4" autoStartCount="3"
    gracefulCompleteTime="14" ldapRoot="cn=cordys,cn=fp1cu7,o=myorg.com"
    name="WS-AppServer container" organization="myorganization"
    override="true" server="cin400599l" servicegroupName="WS-AppServer Test"
    startUpType="true" timeOut="40000">
    <jreconfig>
        <param value="-Xmx256M"/>
        <param value="-XX:PermSize=5m"/>
        <param value="-cp /opt/jopl.jar"/>
    </jreconfig>
    <applicationConnector
        configurationFile="D:\applicationConnectorConfig.xml"
        htmlfile="/cordys/com/cordys/wsappserver/admin/wsappservercodnfig.caf" implementation="com.cordys.cpc.bsf.connector.BsfConnector"/>
</createservicecontainer>

Parameters

Attribute

Description

Type

Required

name

Name of the Service Container.

String

Yes

organization

Provide the name of the organization in which Service Group should be created.

String

Yes

servicegroupName

Name of the Service Group.

String

Yes

osProcess

Name of the OS process.

String

No

startupType

If the value is true, the Service Container starts automatically. If the value is false, start the Service Container manually.

Note: After creating the Service Container using Ant task, auto start requires the Service Container to be restarted.

Boolean

No

timeout

Time out value for handling requests of incoming SOAP requests. Default value is 30000 (ms).

Integer

No

ldapRoot

LDAP root of the Process Platform instance.

String

Yes

server

Name of the server of Process Platform instance where the Service Container should be created(used for distributed environment).

String

Yes

override

Property to update a Service Container. If set to true, the existing Service Container configuration will be overwritten with the latest configuration information

Boolean

No

autoStartCount

Number of attempts to auto-start a Service Container. Default number of attempts is

3. To set infinite, set the value to 0.

Integer

No

gracefulCompleteTime

Time in seconds to complete SOAP transactions gracefully. Default value is 15 (sec).

Integer

No

abortTime

Time in seconds to abort SOAP transactions.

Integer

No

failOnError

Boolean flag tells whether to abort the build when an exception occurs in this task.

Boolean

No

Parameters as nested elements

This task has two nested elements applicationConnector and jreConfig. The properties of these elements are explained below.

applicationConnector

The Ant task can contain any number of applicationConnector elements. But the minimum number of occurrences should be 1.

Attribute

Description

Type

Required

implementation

Fully qualified name of the application connector class.

String

Yes

configurationFile

File path of configuration file which contains application connector specific properties.

String

No

htmlfile

Qualified name of the caf file which is used for providing application connector configuration details.

String

No

jreconfig

  • The element jreconfig is optional. Maximum number of occurrences is 1.
  • It has a child element called 'param'. The param element can be defined any number of times.
    • It has one property called 'value' which is mandatory. Provide JRE parameter of the Service Container here.